ARRAY TO LIST (array; list; {linked array})
                                                                                    Pg 13-10

array              Array       Array to copy to the list
list                  String       List to which to copy the array
linked array    Array        Names of linked lists


ARRAY TO LIST copies array to list. Array must be of type Text or String.

If list does not exist, it is created. If list already exists, array is copied to list thereby replacing the old list.

The array, linked array, is used to link lists to each element in array. If an element of the linked array is not the empty string, then the name in the element is used to link a list to the corresponding item in the list. If that item is not a valid list name, then the link is not established.

ARRAY TO LIST generates the error -9957 when it is applied on a list which is opened in the Design environment and contains the cursor.


The following example copies an array called aRegions into a list called Regions. An array called Links is used to specify the linked lists:

       ARRAY TO LIST (aRegions; "Regions"; Links)



See also:  ARRAY TO SELECTION, LIST TO ARRAY